home *** CD-ROM | disk | FTP | other *** search
/ Eagles Nest BBS 6 / Eagles_Nest_Mac_Collection_Disc_6.TOAST / Other Macintosh Text / ZtermFAQ / ZTerm 0.9 FAQ 1.5.txt next >
Text File  |  1993-10-27  |  72KB  |  1,728 lines
  1. This is the ZTerm 0.9 FAQ, version 1.5, dated October 27, 1993.
  2.  
  3. The FAQ answers frequently asked questions (FAQs) about ZTerm, and 
  4. includes undocumented tips, ResEdit hacks, bug reports, and
  5. bug fixes. Please read this FAQ before sending questions about
  6. ZTerm to ZTerm author Dave Alverson or to comp.sys.mac.comm.
  7.  
  8. Changes since the last version:
  9.  
  10. o  News: the $99 14400 bps LineLink modem
  11. o  News: new ZModem CTB tools available
  12. o  News: Crosstalk 2.0 for Macintosh
  13. o  News: Communicate Lite demo with the Apple Modem Tool 1.5
  14. o  Tip:  adding a separator line to the Dial menu
  15. o  Tip:  changing ZTerm's terminal font with ResEdit
  16. o  Q:    how do I do ZModem uploads to Delphi?
  17. o  Q:    Why is my transfer efficiency so low?
  18.  
  19. My Internet account will change soon. Please direct email to
  20. lesliejonz@aol.com.  --Leslie Jones  
  21.  
  22.  
  23.   
  24.   
  25.   
  26.   
  27.   
  28.                                   ZTerm 0.9 FAQ
  29.                                  by Leslie Jones
  30.   
  31.                                    Version 1.5
  32.                             updated October 27, 1993
  33.   
  34.   
  35.   
  36.   
  37.   
  38.                    For best results, display in 9 point Monaco
  39.                            with rulers set to 7 inches.
  40.   
  41.   
  42.   
  43.   
  44.   
  45.                                  ZTerm News
  46.   
  47.   
  48.                 The TCI LineLink 144e: 14400 bps for $99?
  49.   
  50.   The networks have been buzzing about the "$99 modem." For the first
  51.   time, Mac users can buy a 14400 bps Macintosh modem for under one
  52.   hundred dollars. Though unable to test the modem firsthand, I was
  53.   able to collect a great deal of information from the
  54.   comp.sys.mac.comm newsgroup, reports in the Info-Mac Digest, and
  55.   sales and technical support representatives from MacWAREHOUSE,
  56.   which is the sole distributor of the modem.
  57.   
  58.   Details
  59.   An external modem, the TCI LineLink 144e costs $99.00 and includes
  60.   MacKNOWLEDGE data software, a hardware handshaking cable, and an
  61.   AppleTalk Remote Access script. The modem can send and receive
  62.   faxes and data at 14400 bps. CCITT protocols supported include
  63.   V.42, V.42bis, V.32, and V.32bis. Supports MNP levels 1-5. The
  64.   LineLink uses the Sierra chipset. Order part number BND0249 from
  65.   MacWAREHOUSE (1-800-255-6227).
  66.   
  67.   What's missing
  68.   *Fax software. MacWAREHOUSE offers a MaxFax upgrade for $29.00. The
  69.   Mac Zone sells essentially the same modem under the Performantz
  70.   label for $144.98, which includes MaxFax, MacKNOWLEDGE, and a
  71.   cable, though a Mac Zone representative was unable to confirm
  72.   whether the cable was capable of hardware handshaking, or whether
  73.   an ARA script was included. Order part number 99322 from Mac Zone
  74.   (1-800-436-8000). Several people report successfully configuring
  75.   FAXstf to work with the LineLink. When configuring FAXstf, remember
  76.   that the LineLink uses the Sierra chipset.
  77.   *Decent data software. MacKNOWLEDGE users describe it as barely
  78.   serviceable. Most users will want to download Dave Alverson's
  79.   shareware ZTerm 0.9 or buy a commercial program.
  80.   *Decent documentation. The manual is a scant 28 pages and lacks
  81.   documentation for some of the AT commands and S-registers. Luckily,
  82.   a file exists which documents all of the LineLinkss S-registers.
  83.   Look for the file on America Online or at sumex-aim.
  84.   *Decent tech support. The sales reps and technical support people I
  85.   talked to had never heard of a hardware handshaking cable. The
  86.   response to most problems seems to be "Send the modem back and
  87.   we'll replace it."
  88.   *Separate incoming and outgoing LEDs. If you have an Apple Extended
  89.   Keyboard, there's a software solution for this shortcoming.
  90.   Download John Stephen's MacLights 1.02a control panel, which can
  91.   use the num lock, caps lock, and scroll lock LEDs to indicate
  92.   receive, send, carrier (GPI), handshaking in (CTS/DSR), and
  93.   handshaking out (RTS/DTR). MacLights can also report floppy disk,
  94.   hard disk, and SCSI port activity. Highly recommended for extended
  95.   keyboard owners.
  96.   
  97.   PC compatibility
  98.   Like all external Hayes-compatible modems, the LineLink can be
  99.   outfitted with an adapter cable and used with an IBM-compatible PC.
  100.   The necessary cable is available from most mail order houses.
  101.   MacWAREHOUSE's PC sister company, MicroWarehouse (1-800-367-7080),
  102.   sells the LineLink modem with a PC cable and PC data software for
  103.   $99.95 as part number MM3270.
  104.   
  105.   For use with a PC, set the modem to &R0. &R1 is the Mac setting.
  106.   Some Mac users have received modems set to the PC setting of &R0.
  107.   If you have any trouble with your modem, send it an AT&V command to
  108.   display all settings. If &R0 is set, change it to &R1.
  109.   
  110.   Reliability
  111.   Judging from reports on the networks, LineLinks work fine for some
  112.   users and poorly for others. This is true for all modems, but the
  113.   LineLinks have more than their share of problems. A number of
  114.   people on Usenet have returned defective modems one or more times
  115.   before getting a reliable modem. Luckily, MacWAREHOUSE will replace
  116.   defective units at their expense, though the warranty is limited to
  117.   30 days.
  118.   
  119.   Recommendation
  120.   For modem hobbyists on a budget, the LineLink is a great value,
  121.   with two caveats. First, expect to spend some time monkeying with
  122.   the AT settings. Second, test the modem thoroughly when it arrives.
  123.   In particular, make sure it can connect at speeds higher than 9600
  124.   bps; an inability to connect at 14400 bps seems to be the biggest
  125.   problem owners have. If you find any problems whatsoever, contact
  126.   MacWAREHOUSE immediately and order a replacement.
  127.   
  128.   For business use, this modem is a gamble. It might work fine or it
  129.   might fail at the most inconvenient time. If your business depends
  130.   on its modem for email and faxes, consider investing in a more
  131.   reliable model.
  132.   
  133.   
  134.   
  135.                            CTB Zmodem Tools Arrive
  136.   
  137.   As predicted in last month's ZTerm FAQ, several new ZModem tools
  138.   arrived this month. The first was the long-awaited tool from
  139.   SeaQuest. 
  140.   
  141.   The second was a shocker. DCA has released a Macintosh version of
  142.   Crosstalk, a communications package formerly available only for the
  143.   PC. According to MacWEEK (10.11.93), Crosstalk will use the
  144.   Communications Toolbox and will support XModem, YModem, ZModem,
  145.   Kermit, CompuServe QuickB, IND$FILE, and FTTERM. Terminal emulation
  146.   includes PC ANSI, VT320, ADDS Viewpoint+, HP 700/94, Wyse 50 and
  147.   Televideo 950. Apple's VT102 tool is presumably included as well,
  148.   though this is not confirmed. Owners of the PC version or of
  149.   competing Mac products can upgrade for $49. Contact Digital
  150.   Communications Associates at (404-442-4000).
  151.   
  152.   Aladdin's SITcomm is still in beta, but will include XModem,
  153.   YModem, ZModem, and Kermit tools. SITcomm's most interesting
  154.   features are the ability to convert many file formats on the fly
  155.   during uploading and downloading, and the ability to use
  156.   AppleScript and Frontier to automate online sessions.
  157.   
  158.   The next version of Communicate Lite will include a ZModem tool,
  159.   and will be a free upgrade for current users. The ZModem tool is
  160.   currently in beta.
  161.   
  162.   
  163.                           Communicate Lite Demo Available
  164.   
  165.   A demo version of Mark/Space Softworks' Communicate Lite is
  166.   available from America Online and via anonymous FTP from netcom.com
  167.   in the directory mspace/pub. The demo includes the just-released
  168.   Apple Modem Tool 1.5. For the time being, downloading the
  169.   Communicate Lite demo may be the easiest way to obtain the new
  170.   Apple Modem Tool. 
  171.   
  172.   One outstanding feature of Communicate Lite is the ability to open
  173.   multiple simultaneous communications sessions. Communicate Lite's
  174.   interface is extremely clean. The demo lacks the full version's
  175.   ability to open or save session settings, but is fully functional
  176.   otherwise. The full version of Communicate Lite is available for
  177.   $49.95 plus shipping and handling from Mark/Space Softworks
  178.   (408-982-9781). Internet: mspace@netcom.com; AppleLink, AOL:
  179.   markspace. Look for the demo on America Online, or FTP into
  180.   netcom.com and look in the directory mspace/pub.
  181.   
  182.   
  183.   
  184.     Contents:
  185.   
  186.   ! = New section!
  187.   + = Section updated since the last version of the FAQ
  188.   
  189. + Distribution and Posting Information
  190. + Credits
  191.   Copyright Notice and Trademarks
  192.   Disclaimer
  193. + Contacting the Author
  194.   Other ZTerm Information and Software
  195.   
  196.   [1] ZTerm's Version History
  197.   
  198.   [1.1]  What's the current version?
  199.   [1.2]  What features will be in the next version?
  200.   [1.3]  When will the next version be released?
  201.   
  202.   
  203.   [2] Registration and Support
  204.   
  205.   [2.1]  Why should I register (pay the shareware fee)?
  206.   [2.2]  Will I get technical support if I register?
  207.   [2.3]  If I registered an earlier version of ZTerm, do I have to
  208.          send in an upgrade fee?
  209.   [2.4]  What is Dave's new Internet address?
  210.   
  211.   
  212.   [3]    Quick Fixes for Common Problems
  213.   
  214.   [3.1]  Relax. Don't worry. Have a homebrew.
  215.   [3.2]  Select a download folder to prevent -120 downloading error.
  216.   [3.3]  Make sure ZTerm is sending data to the correct port.
  217.   [3.4]  Make sure call waiting is disabled.
  218. + [3.5]  Make sure you have a hardware handshaking cable.
  219.   [3.6]  Install Apple's Hardware System Update 2.0.
  220.   [3.7]  Quit other programs which use the modem.
  221.   [3.8]  Turn the modem off, wait a few seconds, then turn it
  222.          back on.
  223.   [3.9]  Quit ZTerm, then relaunch ZTerm.
  224.   [3.10] Restart the computer.
  225.   [3.11] Restart the computer with extensions off.
  226.   [3.12] Disable fax software and fax auto-answer.
  227.   [3.13] Move the ZPhoneList out of the ZTerm folder.
  228.          (But don't throw it away!)
  229.   
  230.   
  231.   [4] Known Bugs, ResEdit Fixes, and ResEdit Hacks
  232.   
  233.   [4.1]  Queue dialing
  234.   [4.2]  File appends
  235.   [4.3]  Missing download folder
  236.   [4.4]  UNIX and Opus settings
  237.   [4.5]  Sending returns in scripts
  238.   [4.6]  Text pacing
  239.   [4.7]  Unmarking all services
  240.   [4.8]  Dialing with the scroll buffer scrolled back
  241. ! [4.9]  Non-bugs
  242.   [4.10] Increasing the port buffer size with ResEdit
  243.   
  244.   
  245.   [5] Dialing
  246.   
  247.   [5.1]  Why is one service in the Dial menu and in the Dial
  248.          directory in outline?
  249.   [5.2]  I started ZTerm and the only service listed is called
  250.          Local.  Wa' hoppen?
  251.   [5.3]  My ZPhoneList with a kajillion phone numbers and settings
  252.          got trashed.  Am I screwed?
  253.   [5.4]  Why won't ZTerm send my modem initialization string?
  254.   [5.5]  Using multiple ZPhoneLists.
  255.   [5.6]  Undocumented tip: changing the data rate.
  256.   [5.7]  Undocumented tip: changing parity, data bits, and stop bits.
  257.   [5.8]  Undocumented tip: dialing the current service.
  258. ! [5.9] Undocumented tip: adding a separator line to the Dial menu.
  259.   
  260.   
  261.   [6]    Connecting
  262.   
  263. + [6.1]  When ZTerm dials, the dialing line has the A cut off the
  264.          dial string, like this: TDT 691-7094.  Tell me, tell me!
  265.          Whatever could be wrong?
  266.   [6.2]  Why is ZTerm so slow at sending passwords on some
  267.          services?
  268.   [6.3]  Why isn't there a setting for 14400 bps?
  269.   [6.4]  What data rate should I use with a 14400 bps modem?
  270.   [6.5]  Why can't I connect at 14400 bps?
  271.   [6.6]  How can I prevent my modem from constantly dropping carrier?
  272. + [6.7]  Why won't my modem hangup?
  273.   
  274.   
  275.   [7] File Transfers
  276.   
  277.   [7.1]  This text, binary, MacBinary, and Smart MacBinary stuff
  278.          makes my head spin.  Which should I use?
  279.   [7.2]  When I download Mac files from a PC BBS, the files have
  280.          generic icons and are unusable.  What went wrong?
  281.   [7.3]  Which protocol should I use?
  282.   [7.4]  Does ZTerm support batch ZModem downloads?
  283.   [7.5]  Interrupting ZModem downloads is messy.  What's a modem
  284.          freak to do?
  285.   [7.6]  Can I use ZModem from my VAX account?
  286.   [7.7]  How do I prevent massive CRC errors during ZModem
  287.          downloads from UNIX?
  288.   [7.8]  I have other transfer problems with UNIX.  What's Dave
  289.          been smokin'?
  290.   [7.9]  I have an error-correcting modem.  Which protocol should I
  291.          use?
  292. ! [7.10] Why can't I do ZModem uploads to Delphi?
  293.   [7.11] Where's YModem-G Send?
  294.   [7.12] Why does YModem work on some systems and not others?
  295.   [7.13] Using hardware compression makes my uploads and downloads
  296.          slower.  Wie gehts?
  297. + [7.14] If I have the Kermit/VT102/etc. Tool, will ZTerm support
  298.          Kermit/VT102/etc.?  Are any ZModem tools available?
  299.   [7.15] How can I resume downloads interrupted by a meddling
  300.          cat?
  301. ! [7.16] Hellfire tarnation and a monkey! Why's my transfer
  302.          efficiency so low?
  303.   
  304.   
  305.   [8] Sound, ANSI Graphics, and Color
  306.   
  307.   [8.1]  Why oh why won't the ZTerm sounds play?
  308.   [8.2]  Can I use sounds other than the ones that come with ZTerm?
  309.   [8.3]  Is there any limit on the length of the sounds?
  310.   [8.4]  How do I turn my modem speaker down or off?
  311.   [8.5]  Why can't women see what a great guy I am?
  312.   [8.6]  How do I get ANSI graphics when connecting to a PC BBS?
  313.   [8.7]  I did all of that and the ANSI graphics still look a
  314.          little funny.  What gives?
  315.   [8.8]  How can I add excitement to my dull and monotonous
  316.          existence?
  317.   
  318.   
  319.   [9] VT100 Emulation
  320.   
  321.   [9.1]  I'm wiggin' out, Leslie.  Why don't the home, end, page
  322.          up, and page down keys on my extended keyboard work?
  323.   [9.2]  Why don't the f1-f4 editing keys on my extended keyboard
  324.          work?
  325.   [9.3]  How can I emulate a control key on a Mac Plus?
  326.   [9.4]  How can I emulate an escape key on a Mac Plus?
  327.   [9.5]  How can I emulate a numeric keypad on a PowerBook?
  328.   [9.6]  Undocumented tip: positioning the cursor with the mouse.
  329.   
  330.   
  331.   [10] Text and Text Files
  332.   
  333.   [10.1] Can I make the terminal font bigger?
  334.   [10.2] Why does onscreen text look so crummy in anything but 9 or
  335.          12 point?
  336.   [10.3] Will ZTerm save text files in something other than
  337.          TeachText?
  338.   [10.4] How can I increase the size of the scroll buffer?
  339.   [10.5] Why do some characters get corrupted when I copy text from
  340.          my word processor and paste it into ZTerm?
  341. ! [10.6] Undocumented tip: changing the terminal font with ResEdit.
  342.   
  343.   
  344.   [11]   Macros and Scripting
  345.   
  346.   [11.1] How do I know the script is running?
  347.   [11.2] How do I cancel a script?
  348.   [11.3] How do I send an escape/linefeed/etc. in a script?
  349.   [11.4] Does a ^M have to be in quotation marks?
  350.   [11.5] Do I have to use the Wait for "da da da" prompt syntax?
  351.   [11.6] Why is ZTerm sending only part of a line?
  352.   [11.7] How can I send quotation marks within a send statement?
  353.   [11.8] What does error -49 mean?
  354.   [11.9] I'm goin' nuts! Why won't my login script run?
  355.   [11.10]Login script example.
  356.   [11.11]Undocumented tip: sending a sig with a script and macro.
  357.   [11.12]Other uses of scripts and macros
  358.   
  359.   An Easter Egg
  360.   
  361.   
  362.   
  363.   
  364.   Distribution and Posting Information
  365.   
  366.   America Online
  367.   I always send the current version to America Online.  Use File
  368.   Search keyword "zterm".
  369.   
  370.   FTP
  371.   I will also send the current version to
  372.   macgifts@mac.archive.umich.edu, a mail exploder which delivers the
  373.   file to the sumex-aim and umich FTP sites, as well as other,
  374.   lesser-known  FTP sites.  The following list shows the location of
  375.   the FAQ at various FTP sites, along with the appropriate
  376.   directories.  Sumex and umich are two primary FTP sites.  The other
  377.   sites mirror the contents of either sumex or umich.  The mirrors
  378.   are often easier to access, especially during business hours.  Note
  379.   that the archie.au site is in Australia and that src.doc.ic.ac.uk
  380.   is in the United Kingdom.  To conserve limited Internet resources,
  381.   use the site closest to home.
  382.   
  383.            FTP site                                Directory
  384.   
  385.   sumex-aim.stanford.edu                           
  386.   info-mac/comm/info
  387.   wuarchive.wustl.edu                      
  388.   mirrors/info-mac/comm/info
  389.   archie.au                             
  390.   micros/mac/info-mac/comm/info
  391.   mac.archive.umich.edu                        
  392.   mac/misc/documentation
  393.   wuarchive.wustl.edu
  394.   mirrors/archive.umich.edu/mac/misc/documentation
  395.   archie.au                   
  396.   micros/mac/umich/mac/misc/documentation
  397.   src.doc.ic.ac.uk          
  398.   packages/mac/umich/mac/misc/documentation
  399.   
  400.   Online services
  401.   The only commercial service I send the FAQ to is America Online . 
  402.   If you belong to another online service, I would appreciate it if
  403.   you would upload the FAQ there. Note to Delphi users: if you have
  404.   trouble uploading using ZModem, try switching from rz to uz in
  405.   ZTerm's Zmodem Options.
  406.   
  407.   Usenet
  408.   Each month I will post the current version of the FAQ to the
  409.   comp.sys.mac.* Usenet newsgroups, where * is apps, comm, hardware,
  410.   and portables.
  411.   
  412.   Email
  413.   Harris Upham has generously volunteered to provide the FAQ via
  414.   email.  He requests that you put "ZTerm" somewhere in the subject
  415.   line so he can easily identify FAQ requests.  Harris is being very
  416.   generous with his time.  Please mail him only if you can't get the
  417.   FAQ by other means.  The address is hupham@fscvax.fsc.mass.edu.
  418.   
  419.   
  420.   Credits and Thanks
  421.   
  422.   Many thanks to the folks who have contributed, knowingly or
  423.   unknowingly.  While compiling this FAQ, I was often helped by the
  424.   net community, particularly readers of the Usenet newsgroup
  425.   comp.sys.mac.comm and the Info-Mac Digest.  Thanks to all the
  426.   helpful people out there in netland!  In rough chronological order:
  427.   Neil Schulman, Joe Dellwo, Adam Toner, Rick McCormack, Scott
  428.   Macrae, David Platt, Daniel Friedan, Drew Wade, Gregory Youngs, Roy
  429.   Wood, Gary Snow, Peter Middleton, Eric Hoffmann, Jay Bourland, Pete
  430.   Halverson, Henri Schueler, Miles Abernathy, Jeff Kwan, Kent
  431.   Ritchie, Davey Silon, David Ray, Walter Ian Kaye, Harris Upham,
  432.   Shigeru Yamamoto and Julian Vrieslander.  Others have contributed
  433.   material which I may use in upcoming versions of the FAQ.
  434.   
  435.   Special thanks to ZTerm author Dave Alverson for providing
  436.   information about the next release, and for releasing a great piece
  437.   of software as shareware.
  438.   
  439.   
  440.   Copyright Notice and Trademarks
  441.   
  442.   This document is copyright 1993 by Leslie Jones.  All rights
  443.   reserved.  I ask for no money, but please give credit when quoting
  444.   information in this document.  Crediting the FAQ will make others
  445.   aware of its existence.  Unmodified copies of this document may be
  446.   freely copied and distributed electronically, and may be uploaded
  447.   to FTP sites which allow anonymous login, nonprofit BBSs, and
  448.   commercial online services which charge no more than a normal
  449.   connect fee for downloading files.
  450.   
  451.   For-profit distribution on physical media, including but not
  452.   limited to paper, floppy disk, and CD-ROM, is prohibited without
  453.   written permission.  Explicit permission is granted to the
  454.   moderators and archivists of the sumex-aim archives to include this
  455.   document on the info-mac CD-ROM.  Explicit permission is also
  456.   granted to nonprofit user groups registered with Apple to
  457.   distribute this document on their disk of the month.
  458.   
  459.   This document contains the names of trademarked products.  The
  460.   trademarks are the property of their respective owners, and are
  461.   used here only in an editorial capacity.
  462.   
  463.   Disclaimer
  464.   
  465.   This document is a volunteer effort.  Every attempt has been made
  466.   to provide accurate information, but the author and contributors
  467.   accept no responsibility for actions resulting from the use of this
  468.   free information.  This document is provided as is with no warranty
  469.   of any kind.
  470.   
  471.   
  472.   Contacting the Author
  473.   
  474.   In preparation for a change of Internet accounts, I'm changing my
  475.   preferred mail address.  To make corrections and suggestions, send
  476.   Internet mail to lesliejonz@aol.com, or send America Online mail to
  477.   LeslieJonz.  If mail to that address bounces, send Internet mail to
  478.   ljones@utkvx.utk.edu.  UTK is the University of Tennessee,
  479.   Knoxville, the land of the free and the home of the Vols.
  480.   
  481.   
  482.   
  483.   
  484.   Other ZTerm Information and Software
  485.   
  486.   Information
  487.   
  488.   This FAQ answers questions relating specifically to ZTerm 0.9. 
  489.   There are other sources for information of interest to ZTerm users.
  490.   
  491.   General communications
  492.   For answers to more general questions about Macintosh
  493.   telecommunications and networking, please read Eric Rosen's
  494.   excellent comp-sys-mac-comm FAQ, available for anonymous FTP from
  495.   sumex-aim.stanford.edu and mac.archive.umich.edu.  Everyone who
  496.   uses a modem should keep Eric's FAQ on their hard drive.
  497.   
  498.   File conversion
  499.   For answers to questions about file conversion ("I downloaded a
  500.   file that ends in cpt/sit/dd/arc/lzh/pit/etc.  How do I open it?"),
  501.   get David Lemson's exhaustive report compression-util-table.  The
  502.   ZTerm manual briefly describes the most common Macintosh
  503.   compression formats.
  504.   
  505.   Modem configuration
  506.   For information about configuring your modem, consult your modem's
  507.   manual.  I address specific problems in the FAQ, but there really
  508.   is no substitute for a working knowledge of the Hayes command
  509.   language.  When your AT command reference is torn at the edges and
  510.   soiled with the dirt of your hands, it is then you will know you
  511.   have mastered the art of telecommunications.
  512.   
  513.   Usenet
  514.   If you have Usenet access, questions about Macintosh-specific
  515.   telecommunication hardware and software should be directed to
  516.   comp.sys.mac.comm.  Questions about modems and telecommunications
  517.   in general should be directed to comp.dcom.modems.  I often read
  518.   c.s.m.comm and answer questions about ZTerm by searching for the
  519.   string "zt."  If you post there, please spell ZTerm correctly.  It
  520.   is NOT spelled Z-term.  (Personal rant mode *off*.)  Actually,
  521.   after reading this FAQ, you'll probably be answering ZTerm
  522.   questions, not asking them.
  523.   
  524.   
  525.   Software
  526.   
  527.   ZTerm Phone Directory Listing
  528.   Denise McElroy (dmcelroy@bonnie.ics.uci.edu) released this
  529.   application, which reads your ZPhoneList file and produces a text
  530.   file containing the names and phone numbers of all services.  If
  531.   your ZPhoneList ever gets erased or corrupted, you'll be glad you
  532.   used it.  This application may be also able to extract the phone
  533.   numbers from a corrupted ZPhoneList.
  534.   
  535.   ZTerm High Speed Patch
  536.   Jon Snell (jonsnell@aol.com) wrote a 16 color palette resource and
  537.   ResEdit instructions for installing the palette.  By using the hack
  538.   and setting the monitor depth to 16 colors, ZTerm users will
  539.   experience faster screen redraws while still seeing the correct
  540.   colors.  Users with 2400 bps modems will experience little or no
  541.   speed increase.  In my experience, the patch makes ZTerm faster in
  542.   16 colors, but a little slower in 256 colors.  Highly recommended
  543.   if you normally use 16 color video.
  544.   
  545.   Star Trek sounds
  546.   Star Trek fans now have their own sounds for ZTerm!  The sounds are
  547.   available on America Online as M's ZSounds, and at sumex-aim as
  548.   star-trek-comm-sounds in the info-mac/snd directory.  These are the
  549.   coolest ZTerm sounds I've used.  The sounds are as follows:
  550.   
  551.   Connect:   Worf saying "Link established.  Receiving."
  552.   Filedone:  Worf saying "Transfer of information complete."
  553.   Termbell:  Enterprise computer beep.
  554.   
  555.   
  556.   
  557.   
  558.   [1]    ZTerm's Version History
  559.   
  560.   [1.1]  What's the current version?
  561.   
  562.   ZTerm 0.9 is the current version.  It is dated February 8, 1992.
  563.   Before 0.9 was released, someone hacked 0.85 with ResEdit and
  564.   released it as 1.0.  There is a more recent hack called 0.93 XK
  565.   (eXtra Keys), which was released by a user group.  Anyone may
  566.   modify ZTerm with ResEdit for their personal use, but distributing
  567.   modified versions of copyrighted software is illegal.  If you
  568.   discover an interesting ResEdit hack, send it to me and I'll
  569.   publish it in the FAQ.
  570.   
  571.   Dave Alverson sends official releases to America Online,
  572.   CompuServe, and GEnie.  You can also expect the newest version to
  573.   appear quickly on BBSs and FTP sites.
  574.   
  575.   [1.2]  What features will be in the next version?
  576.   
  577.   Support for Kermit file transfers.
  578.   
  579.   Implementation of 16 color ANSI graphics, instead of the current 8
  580.   colors.
  581.   
  582.   Some additions to the scripting language.
  583.   
  584.   A scripts folder, possibly.
  585.   
  586.   Bug fixes.
  587.   
  588.   [1.3]  When will the next version be released?
  589.   
  590.   The original goal was second quarter, 1993, conditional on Dave
  591.   finding enough spare time.  That date has now passed.  We all hope
  592.   the next version will appear Real Soon Now.
  593.   
  594.   
  595.   [2]    Registration and Support
  596.   
  597.   [2.1]  Why should I register (pay the shareware fee)?
  598.   
  599.   This is a tough question. There is no legal precedent to show that
  600.   people can be forced to pay for shareware, so one will come
  601.   knocking on your door in the middle of the night.  On the other
  602.   hand, many of us in the computer community feel that you should pay
  603.   for shareware which you use often, just because it seems to us to
  604.   be the right thing to do.  Shareware authors put a lot of work into
  605.   their software, and they deserve compensation.  Shareware authors
  606.   also put a lot of faith in the computer community by releasing
  607.   their products as shareware.  They trust that people will
  608.   voluntarily pay for a product they need and use.  I for one don't
  609.   think we should take advantage of people's trust.
  610.   
  611.   There are also practical reasons for registering.  Registering
  612.   encourages the author to update his software.  More importantly,
  613.   the author is more likely to continue to release his work as
  614.   shareware if people pay the registration fee.
  615.   
  616.   The copy of ZTerm which ships with some Global Village modems has
  617.   been paid for by the nice people at Global Village, who know a good
  618.   piece of software when they see it.
  619.   
  620.   [2.2]  Will I get technical support if I register?
  621.   
  622.   Yes.  Dave supports ZTerm through paper mail, email, and in
  623.   conferences on America Online, CompuServe, and GEnie.  The
  624.   locations of the conferences are listed in the Support dialog under
  625.   the Misc menu.  Registered users receive his home phone number and
  626.   can call him for direct phone support.  When was the last time you
  627.   called a Microsoft programmer at home?
  628.   
  629.   If you send Dave a question, include the registration number you
  630.   received when you registered ZTerm, as Dave almost certainly gives
  631.   priority to registered users.
  632.   
  633.   Global Village handles technical support for the Global Village
  634.   version of ZTerm.
  635.   
  636.   [2.3]  If I registered an earlier version of ZTerm, do I have to
  637.          send in an upgrade fee?
  638.   
  639.   No.  Dave Alverson, like most shareware authors, doesn't charge
  640.   upgrade fees.  This is another advantage of shareware.
  641.   
  642.   [2.4]  What is Dave's new Internet address?
  643.   
  644.   The address given in ZTerm 0.9 is out of date.  Dave's new Internet
  645.   address is davea@xetron.com, and is his preferred mail address.
  646.   
  647.   
  648.   [3]    Quick Fixes for Common Problems
  649.   
  650.   [3.1]  Relax. Don't worry. Have a homebrew.
  651.   
  652.   Keep your head tool cool.  Read the manual, read this FAQ, and
  653.   remember that tens of thousands of people have used ZTerm
  654.   successfully.
  655.   
  656.   Before you use ZTerm for the first time:
  657.   
  658.   [3.2]  Select a download folder to prevent -120 downloading error.
  659.   
  660.   Before downloading files for the first time, you must select a
  661.   default download folder by selecting Receive Folder from the
  662.   Settings menu.  If you can upload files but can't download them,
  663.   you probably haven't selected a receive folder.  Remember to select
  664.   a new folder when moving to a new computer.
  665.   
  666.   [3.3]  Make sure ZTerm is sending data to the correct port.
  667.   
  668.   An external modem can be connected to the modem or printer ports.
  669.   Find out which yours is attached to, select Modem Preferences from
  670.   the Settings menu, and select the port.  Alternatively, you can
  671.   hold down the shift key while ZTerm loads to select the port.  If
  672.   you have a PowerBook with an internal modem, open the PowerBook
  673.   control panel and select the option for an internal modem.
  674.   
  675.   All things being equal, you should connect an external modem to the
  676.   modem port.  The computer gives priority to the modem port so that
  677.   other printer port activities don't interfere with modem
  678.   activities.  Also, all AppleTalk devices must be connected to the
  679.   printer port, which is the only AppleTalk-capable port.
  680.   
  681.   [3.4]  Make sure call waiting is disabled.
  682.   
  683.   To disable call waiting on a touch tone phone, insert the string
  684.   "*70," before the phone number, like this:
  685.   
  686.   ATDT *70,555-5555
  687.   
  688.   The comma is a Hayes command which makes the modem wait for two
  689.   seconds.  Someone has suggested using w instead of a comma.  The w
  690.   tells the modem to wait for a dial tone.  On a pulse dial phone,
  691.   use "1170," instead of "*70,".  One reader reports that *67 enables
  692.   privacy (disables caller ID at the remote phone) for some telephone
  693.   companies.
  694.   
  695.   [3.5]  Make sure you have a hardware handshaking cable.
  696.   
  697.   If you have hardware handshaking turned on in the Connection
  698.   dialog, consult your modem manual to make sure you have a hardware
  699.   handshaking cable.  You can get away without one for awhile, but
  700.   they are ultimately necessary for high speed modems.
  701.   
  702.   A diagram of a correctly-wired hardware handshaking cable is hidden
  703.   in the Apple Modem Tool 1.1.  Open a copy in ResEdit and examine
  704.   PICT resource #20000.  In the Apple Modem Tool 1.5, the PICT
  705.   resources are #20808 for DIN-8 to DIN-8 wiring, and #20825 fro
  706.   DIN-8 to DB-25 wiring.  The new Apple Modem Tool 1.5 has a button
  707.   labelled Cabling, but it was grayed out on my machine.  I suspect
  708.   the button would work with an Apple Express Modem.  Any information
  709.   on the cabling button would be appreciated.
  710.   
  711.   To find out more about hardware handshaking, read issues #179 and
  712.   #180 of TidBITS, Adam Engst's free electronic magazine, available
  713.   from FTP sites and online services.
  714.   
  715.   [3.6]  Install Apple's Hardware System Update 2.0.1.
  716.   
  717.   The hardware update (AKA Hardware Enabler) corrects some problems
  718.   with high speed communications under System 7.1 on the following
  719.   machines: LC, LC II, IIsi, IIvx, IIvi, Classic II, Quadra 900, and
  720.   Quadra 950.  The updater solves other problems on these and other
  721.   machines, so users of System 7.1 should probably have it anyway. 
  722.   The updater should NOT be used on Performas. 
  723.   
  724.   I mention the hardware update out of a sense of duty to inform you
  725.   that it exists.  No one has actually reported that it solved any of
  726.   their telecommunications problems.  On the contrary, reports are
  727.   filtering in that the update causes some problems of its own.  Use
  728.   your own judgement.
  729.   
  730.   Day-to-day fixes:
  731.   
  732.   [3.7]  Quit other programs which use the modem.
  733.   
  734.   Communications programs that access the modem are sometimes
  735.   reluctant to give up control of the port the modem is attached to. 
  736.   Quit all other telecommunications software, as well as any phone
  737.   book programs that can dial phone numbers through the modem.
  738.   
  739.   [3.8]  Turn the modem off, wait a few seconds, then turn it
  740.          back on.
  741.   
  742.   This technique solves numerous connection and downloading problems.
  743.   Among other things, it closes the communications port, which may
  744.   have been left open by another application.
  745.   
  746.   [3.9]  Quit ZTerm, then relaunch ZTerm.
  747.   
  748.   Among other things, this forces ZTerm to resend the modem
  749.   initialization string.
  750.   
  751.   [3.10] Restart the computer.
  752.   
  753.   Restarting is a standard way of solving transient problems of any
  754.   kind.
  755.   
  756.   [3.11] Restart the computer with extensions off.
  757.   
  758.   Extensions (inits and cdevs under System 6) cause more than their
  759.   share of problems, and should always be suspect if the machine is
  760.   crashing or freezing.  Under System 7, restart with the shift key
  761.   held down to prevent extensions from loading.  Under System 6,
  762.   manually remove all inits and cdevs from the System Folder and
  763.   restart.
  764.   
  765.   See also 3.12.
  766.   
  767.   A few final possibilities:
  768.   
  769.   [3.12] Disable fax software and fax auto-answer.
  770.   
  771.   Fax software may prevent ZTerm from accessing the serial port to
  772.   which the modem is attached.  Remove fax extensions, control panels
  773.   and Chooser devices from the System folder.  Fax Chooser devices
  774.   are especially insidious.  Chooser devices aren't disabled when you
  775.   restart with extensions off under System 7.  If they were, print
  776.   drivers would be disabled, and you wouldn't be able to print.
  777.   
  778.   Consult your fax modem manual to learn how to disable fax
  779.   auto-answer.
  780.   
  781.   [3.13] Move the ZPhoneList out of the ZTerm folder.
  782.          (But don't throw it away!)
  783.   
  784.   Besides storing phone numbers, the ZPhoneList contains all of
  785.   ZTerm's settings and preferences, which may have been misset or
  786.   corrupted.  If you remove the file from the ZTerm folder, ZTerm
  787.   will create a new one using its default settings.  You can also
  788.   restore the file from a backup disk.  If that doesn't solve the
  789.   problem, put your old ZPhoneList back in the ZTerm folder so you
  790.   won't lose your phone numbers.
  791.   
  792.   
  793.   [4]    Known Bugs, ResEdit Fixes, and ResEdit Hacks
  794.   
  795.   [4.1]  Queue dialing
  796.   
  797.   When queue dialing, the dial window remains open after a connection
  798.   is made.
  799.   
  800.   [4.2]  File appends
  801.   
  802.   Appended text is inserted at the beginning of the file, rather than
  803.   at the end.
  804.   
  805.   [4.3]  Missing download folder
  806.   
  807.   If you attempt to download without selecting a default download
  808.   folder, ZTerm reports a -120 error instead of prompting you to
  809.   select a download folder.
  810.   
  811.   [4.4]  UNIX and Opus settings
  812.   
  813.   The radio buttons may change when you open the ZModem Options
  814.   dialog, but the settings remain unchanged, so the bug is not
  815.   serious.
  816.   
  817.   [4.5]  Sending returns in scripts
  818.   
  819.   When ZTerm sends a return by itself in a script, it usually sends a
  820.   space, then the return.  To fix the problem, open a copy of ZTerm
  821.   in ResEdit. Open the CODE resource, then open CODE ID=2. At offset
  822.   52B4 find the string 671E 4A6E FFEE.  Change 671E to 601E.
  823.   
  824.   [4.6]  Text pacing
  825.   
  826.   If text pacing is set to wait for a line prompt, ZTerm will usually
  827.   wait for about 5 seconds even if it receives the prompt character. 
  828.   To fix this bug, open a copy of ZTerm in ResEdit, open the CODE
  829.   resource, then open CODE ID=2.  At offset 5082, find the string
  830.   3B40 CAC0.  Change CAC0 to CABE.
  831.   
  832.   [4.7]  Unmarking all services
  833.   
  834.   Holding down shift-option and selecting Dial Marked is supposed to
  835.   unmark all services, but doesn't.
  836.   
  837.   [4.8]  Dialing with the scroll buffer scrolled back
  838.   
  839.   When dialing with the scroll buffer scrolled back, ZTerm crashes
  840.   when a connection is made.  This bug does not occur on all systems,
  841.   but occurs reproducibly on some.
  842.   
  843.   [4.9]  Non-bugs
  844.   
  845.   When the Dial directory is open, command-q invokes queue dialing,
  846.   rather than quitting ZTerm.  According to the ZTerm docs, this is
  847.   exactly what's supposed to happen.  Several other command key
  848.   shortcuts have different meanings when the Dial directory is open.
  849.   
  850.   When ANSI graphics leave the main window and enter the scroll
  851.   buffer, they lose their special formatting and color and become
  852.   text.  This is described in the ZTerm docs.
  853.   
  854.   [4.10]  Increasing the port buffer size with ResEdit
  855.   
  856.   Open a copy of the ZPhoneList in ResEdit.  Doubleclick the zSet
  857.   resource.  The first two bytes are the port buffer size.  X'1000 =
  858.   4K.  X'2000 = 8K.  X'3000 = 12K, etc.  Settings higher than X'7
  859.   (28K) are reported to be unreliable.  
  860.   
  861.   See also 5.9 to learn how to change the terminal font with ResEdit.
  862.   
  863.   
  864.   [5]    Dialing
  865.   
  866.   [5.1]  Why is one service in the Dial menu and in the Dial
  867.          directory in outline?
  868.   
  869.   That's the default service.  When you launch ZTerm, that service
  870.   will be the current service.  To set the default service, open the
  871.   Dial directory, hold down the command key, and click on the service
  872.   you want to be the default.  You can also hold down the command key
  873.   and select the service from the Dial menu.
  874.   
  875.   [5.2]  I started ZTerm and the only service listed is called
  876.          Local.  Wa' hoppen?
  877.   
  878.   ZTerm didn't find your ZPhoneList in the ZTerm folder, so it
  879.   created a new one with the default entry Local.  Find your
  880.   ZPhoneList and place it in the root level of the ZTerm folder.
  881.   
  882.   [5.3]  My ZPhoneList with a kajillion phone numbers and settings
  883.          got trashed.  Am I screwed?
  884.   
  885.   You're screwed.  Always back up your ZPhoneList when you perform
  886.   your routine backup.  Or, to put it another way, whenever you think
  887.   "Man, I really oughta back up my files one of these days," instead
  888.   think "Man, I really oughta back up my files, including my
  889.   ZPhoneList, one of these days."
  890.   
  891.   Several reports on comp.sys.mac.comm indicate that the ZPhoneList
  892.   can be corrupted when restarting a crashed Mac.  Apparently this
  893.   only occurs if you crash after making changes to the ZPhoneList
  894.   settings without saving the changes.  You can prevent this problem
  895.   by choosing Save Setup from the Dial menu whenever you change
  896.   ZTerm's settings.
  897.   
  898.   If your ZPhoneList becomes corrupted, you might be able to extract
  899.   the service names and numbers using Denise McElroy's ZTerm Phone
  900.   Directory Listing, available from FTP sites and America Online.
  901.   
  902.   [5.4]  Why won't ZTerm send my modem initialization string?
  903.   
  904.   ZTerm won't initialize the modem if the default service doesn't
  905.   have any characters in the Phone Number field.  To fix the problem,
  906.   type some characters in the field.  The characters don't have to be
  907.   a phone number.  "I am the Lizard King" works just fine.  So does a
  908.   couple of spaces.
  909.   
  910.   [5.5]  Using multiple ZPhoneLists.
  911.   
  912.   When you launch ZTerm, it looks for a file called ZPhoneList in the
  913.   ZTerm folder.  To force ZTerm to use a different ZPhoneList, quit
  914.   ZTerm and doubleclick on the other ZPhoneList, which does not have
  915.   to be in the ZTerm folder.  If multiple ZPhoneLists are present in
  916.   the ZTerm folder, they must have different names.
  917.   
  918.   To force ZTerm to create a new ZPhoneList, rename the old one, or
  919.   move it out of the ZTerm folder, and launch ZTerm.
  920.   
  921.   [5.6]  Undocumented tip: changing the data rate.
  922.   
  923.   You can change the data rate without going to the connection
  924.   dialog. Click on the data rate string at the bottom of the window
  925.   to get a popup menu for changing the data rate.
  926.   
  927.   [5.7]  Undocumented tip: changing parity, data bits, and stop bits.
  928.   
  929.   Likewise, clicking on the string to the right of the data rate
  930.   string produces a popup menu for selecting N-8-1, E-7-1, or O-7-1
  931.   settings.
  932.   
  933.   [5.8] Undocumented tip: dialing the current service.
  934.   
  935.   Command-shift-d normally dials marked services.  If no services are
  936.   marked, command-shift-d dials the current service.
  937.   
  938.   [5.9]  Undocumented tip: adding a separator line to the Dial menu.
  939.   
  940.   Create a new service.  In the Service Name field, type one or more
  941.   "-" (hyphens).  The Dial menu will now have a standard gray
  942.   separator line.  To take advantage of the separator, some of your
  943.   service names must come alphabetically before the hyphen.  The
  944.   easiest way to do this is to prefix some of the service names with
  945.   spaces, which forces them to the top of the Dial menu.
  946.   
  947.   P.S. I have lost the name of the person who posted this tip to
  948.   comp.sys.mac.comm.  If that person would be so kind as to send me
  949.   their name, I'll add it to the credits.
  950.   
  951.   
  952.   [6]    Connecting
  953.   
  954.   [6.1]  When ZTerm dials, the dialing line has the A cut off the
  955.          dial string, like this: TDT 691-7094.  Tell me, tell me!
  956.          Whatever could be wrong?
  957.   
  958.   First, make sure your modem is turned on, that the modem cable is
  959.   properly connected to the computer and to the phone jack, and that
  960.   ZTerm is sending data to the correct port.
  961.   
  962.   Assuming all is well with the modem connection, the consensus seems
  963.   to be that this behavior occurs because a previous comm program
  964.   left the communications port open.  If you witness this behavior,
  965.   quit ZTerm, turn the modem off and then back on, and relaunch
  966.   ZTerm.  One person reported that changing the data rate from 57600
  967.   to 38400 solved his problem.  Another fixed the problem on his
  968.   PowerBook by adding a comma to the beginning of the predial
  969.   initialization string.
  970.   
  971.   Thanks to everyone on comp.sys.mac.comm and comp.dcom.modems for
  972.   their valuable feedback on this problem!
  973.   
  974.   [6.2]  Why is ZTerm so slow at sending passwords on some
  975.          services?
  976.   
  977.   You have "Wait for character echo" turned on in the Text Pacing
  978.   options, but the remote system isn't echoing the password
  979.   characters, so ZTerm waits 5 seconds, times out, and sends the next
  980.   character.  Turn off the "Wait for character echo" option for that
  981.   service.
  982.   
  983.   [6.3]  Why isn't there a setting for 14400 bps?
  984.   
  985.   The setting in the connection dialog controls the DTE speed (AKA
  986.   terminal speed, Mac-to-modem speed, serial port speed, or what
  987.   ZTerm calls the data rate), not the DCE speed (AKA connection
  988.   speed, modem-to-modem speed, or carrier speed).  14400 is a DCE
  989.   speed, not a DTE speed.
  990.   
  991.   [6.4]  What data rate should I use with a 14400 bps modem?
  992.   
  993.   With a high speed modem, you want to set the serial port speed
  994.   higher than the carrier speed so that the modem won't get ahead of
  995.   the computer.  Also, most v.32bis (14400 bps) modems feature
  996.   hardware compression methods such as v.42bis and MNP 5.  To take
  997.   advantage of hardware compression, the serial port speed must be
  998.   higher than the carrier speed.
  999.   
  1000.   When using a 14400 bps modem to connect to another 14400 bps modem,
  1001.   set the DTE speed in the Connection dialog to 19200.  You can
  1002.   experiment with higher values, but 19200 should work reliably. 
  1003.   Some users report that high DTE speeds are unreliable when
  1004.   AppleTalk is enabled in the Chooser DA.  Many people experience
  1005.   problems with 57600 DTE speeds.
  1006.   
  1007.   [6.5]  Why can't I connect at 14400 bps?
  1008.   
  1009.   Send the modem an AT&V command, which will display all settings. If
  1010.   you see \J1, you've found the problem.  \J1 enables port rate
  1011.   adjust.  (This setting may be something other than \J on some
  1012.   modems. Check your manual.)  This means that the DTE speed will
  1013.   adjust to the DCE speed.  But if you connect at 14400 bps, you're
  1014.   in trouble, since ZTerm can't send data to the serial port at 14400
  1015.   bps.  To fix the problem, send AT\J0 (zero) to the modem.  Better
  1016.   yet, add \J0 to the modem initialization string in the Modem
  1017.   Preferences dialog.
  1018.   
  1019.   [6.6]  How can I prevent my modem from constantly dropping carrier?
  1020.   
  1021.   Tell the modem to ignore DTR.  The appropriate string for most
  1022.   modems is &D0.  You cannot use hardware handshaking if &D0 is set. 
  1023.   Be sure to read the section 6.7 to avoid problems hanging up the
  1024.   phone line.
  1025.   
  1026.   See also 3.4 if you have call waiting.
  1027.   See also 3.12 if you have a fax modem.
  1028.   
  1029.   [6.7]  Why won't my modem hangup?
  1030.   
  1031.   The modem's &D setting and ZTerm's setting for hardware (DTR)
  1032.   hangup are conflicting.  The setting is in ZTerm's Modem
  1033.   Preferences dialog.  Send the command AT&V to your modem to find
  1034.   your &D setting, and set the hardware hangup according to the
  1035.   following table:
  1036.   
  1037.    If your modem is              Use this setting in ZTerm's
  1038.      set to this:                     Modem Preferences:
  1039.   
  1040.        &D0                    Set Hardware Hangup (DTR) to off
  1041.        &D1                    Set Hardware Hangup (DTR) to off.
  1042.        &D2                    Set Hardware Hangup (DTR) to on.
  1043.        &D3                    Set Hardware Hangup (DTR) to on.
  1044.   
  1045.   Note that I'm assuming you've set &D to the correct setting.  If
  1046.   not, all bets are off.  Check the "Hardware Hangup (DTR)" box to
  1047.   turn hardware hangup on.  Uncheck the box to turn it off.  If all
  1048.   else fails, turn DTR hangup off.  DTR hangup is faster, but
  1049.   software hangup works almost every time.
  1050.   
  1051.   
  1052.   [7]    File Transfers
  1053.   
  1054.   [7.1]  This text, binary, MacBinary, and Smart MacBinary stuff
  1055.          makes my head spin.  Which should I use?
  1056.   
  1057.   Unless you know better, use Smart MacBinary, which will
  1058.   automatically select the correct transfer mode.  The major
  1059.   exception is if you are uploading non-text files, such as GIFs or
  1060.   .zip files, which PC users will use.  In that case, use binary to
  1061.   prevent Finder information from being sent.
  1062.   
  1063.   This reason this setting is so important is because of the Mac's
  1064.   unique file format.  Macintosh files have two forks, or parts --
  1065.   the data fork and the resource fork.  The data fork holds data,
  1066.   i.e. text.  The resource fork holds resources such as compiled
  1067.   code, pictures, sounds, etc.  Text files are usually all data. 
  1068.   Applications are mostly resources.  This two part structure is
  1069.   unique to the Mac.  If you send Mac files to other types of
  1070.   computers, the files will be damaged.  Using MacBinary transfers
  1071.   prevents this damage.
  1072.   
  1073.   [7.2]  When I download Mac files from a PC BBS, the files have
  1074.          generic icons and are unusable. What went wrong?
  1075.   
  1076.   You didn't use MacBinary or Smart MacBinary. See 7.1.
  1077.   
  1078.   [7.3]  Which transfer protocol should I use?
  1079.   
  1080.   If the service you're calling supports ZModem, use it, because:
  1081.   
  1082.   1. ZModem is very fast.
  1083.   
  1084.   2. ZModem is a batch protocol, meaning you can place more than one
  1085.   file into a batch for uploading or downloading.  Most protocols
  1086.   make you request files one at a time.
  1087.   
  1088.   3. ZModem has crash recovery.  If a 3 hour download is interrupted
  1089.   1 minute before it finishes, you can redial the service, start the
  1090.   download again, and finish where you left off.
  1091.   
  1092.   4. ZModem receives begin automatically.  To start a ZModem
  1093.   download, simply tell the other computer to begin the transfer. 
  1094.   Your computer will detect a ZModem transfer and automatically enter
  1095.   receive mode.  This autoreceive feature necessitates the default
  1096.   download folder, which ZTerm also uses with other transfer
  1097.   protocols.
  1098.   
  1099.   5. ZModem handles XON/XOFF software flow control better than other
  1100.   protocols.
  1101.   
  1102.   6. ZModem detects the presence of hardware error correction, such
  1103.   as MNP 4 and v.42, and turns off its own error detection.  The
  1104.   result is faster throughput when using error-correcting modems.
  1105.   
  1106.   [7.4]  Does ZTerm support batch ZModem downloads?
  1107.   
  1108.   Yes.  ZModem is by definition a batch protocol.  To download
  1109.   multiple files from UNIX using ZModem, use the command
  1110.   
  1111.     sz -w 2048 file1.txt file2.hqx etc.
  1112.   
  1113.   [7.5]  Interrupting ZModem downloads is messy.  What's a modem
  1114.          freak to do?
  1115.   
  1116.   Send an ASCII abort or interrupt character.  The abort character
  1117.   varies from host to host, but should be either control-x or
  1118.   control-k.  Control-c is the ASCII interrupt character.  Whichever
  1119.   character you send, type it repeatedly.
  1120.   
  1121.   [7.6]  Can I use ZModem from my VAX or UNIX account?
  1122.   
  1123.   Yes.  The necessary source code for VAX is available via anonymous
  1124.   FTP from ee.utah.edu in the directory /Comm/Rzsz.  You will need
  1125.   everything but the .tar file.  The source code is too large to fit
  1126.   into my account, so I am currently trying to obtain the executable
  1127.   binary.
  1128.   
  1129.   The source code for UNIX is available via anonymous FTP from
  1130.   sumex-aim.stanford.edu in the directory info-mac.comm.  The four
  1131.   files are in UNIX shar format.  I am told that they are not in ANSI
  1132.   C format.  My informant says that UNIX users can use the K & R
  1133.   compiler and use the command -cckr.  
  1134.   
  1135.   [7.7]  How do I prevent massive CRC errors during ZModem
  1136.          downloads from UNIX?
  1137.   
  1138.   Try the following suggestions from Fernmail author Dave Platt:
  1139.   
  1140.   "The commonest reason for this sort of failure-to-resynchronize is,
  1141.   in my experience, excessive data buffering between the sending "sz"
  1142.   process and the receiving program.  The ZMODEM protocol can become
  1143.   badly confused if you're connected to your host via a TCP-based
  1144.   terminal server or some similar serial data switch.  If the
  1145.   terminal server and the network software provides a substantial
  1146.   amount of data buffering (as it probably does), then the two ZMODEM
  1147.   processes will each see a _long_ delay between the time that they
  1148.   send a message to their peer, and the time that the response to
  1149.   this message makes it through the network to them.  This delay will
  1150.   interfere with the protocol's error-recovery timeouts, and can lead
  1151.   to an endless stream of recovery attempts.
  1152.   
  1153.   "I strongly suggest using the poorly-documented "-w" option when
  1154.   downloading files from a mainframe or workstation, unless you're
  1155.   _sure_ that all of the data communication links between you and the
  1156.   host are running at the same speed and don't do data buffering. 
  1157.   The "-w" option enables a four-packet sliding-window mode, which
  1158.   will guarantee that sz will never "get ahead" of your Mac by more
  1159.   than the window-size that you specify.  As long as the window size
  1160.   is no more than (e.g.) 10 seconds worth of data, there won't be a
  1161.   problem with the retry timers expiring before the window is
  1162.   emptied.
  1163.   
  1164.   "I usually use "sz -w 2048 filename" when downloading.  In fact, I
  1165.   have "sz" aliased to "sz -w 2048" to ensure that I don't forget to
  1166.   use windowed mode."
  1167.   
  1168.   [7.8]  I have other transfer problems with UNIX.  What's Dave
  1169.          been smokin'?
  1170.   
  1171.   If you have trouble with UNIX when you use the telnet command, try
  1172.   the rlogin command, and vice versa.  This tip has solved many
  1173.   problems for UNIX users.
  1174.   
  1175.   [7.9] I have an error-correcting modem.  Which protocol should I
  1176.         use?
  1177.   
  1178.   You should probably still use ZModem, but you might also consider
  1179.   YModem-G.  Other protocols have software error correction which is
  1180.   redundant and time consuming if your modem has hardware error
  1181.   checking.  (Note that ZModem has error detection, but turns off its
  1182.   own error correction if it senses a reliable connection between two
  1183.   error-correcting modems.)  Be sure that hardware error correction
  1184.   is enabled on both modems.  Consult your modem manual for
  1185.   instructions.  The downside to YModem-G is that there is no error
  1186.   recovery, so the transfer terminates if an error is detected.  For
  1187.   this reason, you shouldn't use YModem-G if you have noisy phone
  1188.   lines or are transferring large files.
  1189.   
  1190.   [7.10] Why can't I do ZModem uploads to Delphi?
  1191.   
  1192.   One person reports that changing the ZModem options from rz to uz
  1193.   fixed his uploading problems.
  1194.   
  1195.   [7.11] Where's YModem-G Send?
  1196.   
  1197.   According to ZTerm's excellent Balloon Help, YModem1K send is the
  1198.   same as YModem-G send.
  1199.   
  1200.   [7.12] Why does YModem work on some systems and not others?
  1201.   
  1202.   What some BBSs call YModem is actually XModem-1K.  If the BBS
  1203.   offers YModem and YModem Batch, use YModem Batch, which is the true
  1204.   YModem ZTerm expects.  Otherwise, if YModem transfers aren't
  1205.   working, tell the BBS to send YModem, and tell ZTerm to receive
  1206.   XModem-1K.  Frankly, this is just one more reason to use ZModem.
  1207.   
  1208.   [7.13] Using hardware compression makes my uploads and downloads
  1209.          slower.  Was ist los?
  1210.   
  1211.   Most online files are compressed with software utilities such as
  1212.   Stuffit and Compact Pro and can't be compressed much more, if at
  1213.   all.  Therefore, the time the modem spends trying to compress and
  1214.   decompress the files can actually slow down the transfers.  V.42bis
  1215.   is supposed to detect compressed files and turn off its own
  1216.   compression, but it doesn't always work  If hardware compression
  1217.   causes problems, consult your modem manual to learn how to turn it
  1218.   off.
  1219.   
  1220.   [7.14] If I have the Kermit/VT102/etc. Tool, will ZTerm support
  1221.          Kermit/VT102/etc.?  Are any ZModem tools available?
  1222.   
  1223.   No.  ZTerm doesn't use the Communications Toolbox for terminal
  1224.   emulation, connection, or file transfer, so it can't use
  1225.   Communications Toolbox tools.  The freeware Termy, by Tim Endres of
  1226.   Ice Engineering, can.  I've used Termy and Kermit Tool GH with
  1227.   great success.  Kermit Tool GH also works very well with
  1228.   Communicate Lite.
  1229.   
  1230.   There are no freeware or shareware ZModem tools available at this
  1231.   time.  Payware ZModem tool currently available include Pacer
  1232.   Software's PacerTerm (see MacWEEK (08.09.93) and Seaquest's tools
  1233.   pack.  When released, Aladdin System's SITcomm will includ a ZModem
  1234.   tool.  The next version of Communications Lite from Mark/Space
  1235.   Softworks will also include a ZModem tool, and will be a free
  1236.   upgrade for registered users.  A demo version of Communicate Lite
  1237.   is available from America Online and via anonymous FTP from
  1238.   netcom.com in the directory mspace/pub.
  1239.   
  1240.   By the time you read this, Crosstalk for Macintosh 2.0 by Digital
  1241.   Communications Associates, Inc. should be available.  According to
  1242.   MacWEEK (10.11.93), Crosstalk will support XModem, YModem, ZModem,
  1243.   Kermit, CompuServe QuickB, IND$FILE, and FTTERM. Terminal emulation
  1244.   includes PC ANSI, VT320, ADDS Viewpoint+, HP 700/94, Wyse 50 and
  1245.   Televideo 950.  Owners of the PC version or of competing Mac
  1246.   programs can upgrade for $49.  Contact Digital Communications
  1247.   Associates at (404-442-4000).
  1248.   
  1249.   Look for reviews of SITcomm and Communicate Lite in an upcoming
  1250.   FAQ.
  1251.   
  1252.   [7.15] How can I resume downloads interrupted by a meddling
  1253.          cat?
  1254.   
  1255.   If an animal, two legged or four legged, presses the 9 key during a
  1256.   download, ZTerm will display
  1257.   
  1258.      zrdata: cnt = 1024
  1259.      zrdat32: cnt = 1024
  1260.   
  1261.   et cetera ad nauseam.  To fix the problem, press the 0 (zero) key. 
  1262.   My friend Neil Schulman discovered this.  Dave Alverson tells him
  1263.   this behavior is actually a debugger built into ZTerm.  More
  1264.   details as they become available, modem fans.
  1265.   
  1266.   [7.16] Hellfire tarnation and a monkey! Why's my transfer
  1267.          efficiency so low?
  1268.   
  1269.   It may not be low at all.  Ignore the percent efficiency figure. 
  1270.   The characters per second (cps) rate is a better indicator of
  1271.   efficiency.  On the Mac, one character is eight bits.  Sending that
  1272.   characer over a phone line requires the addition of a start bit and
  1273.   a stop bit.  To convert cps to bits per second (bps), multiply cps
  1274.   by ten.  The maximum theoretical efficiency without hardware
  1275.   compression or error correction would be 240 cps for 2400 bps
  1276.   modems, 960 for 9600, and 1440 for 14400.  The efficiency won't be
  1277.   that high, because of line noise and the overhead inherent in any
  1278.   file transfer protocol.  Hardware error correction such as MNP 4
  1279.   and V.42 can increase throughput by as much as eight percent. 
  1280.   Hardware compression such as MNP 5 and V.42bis can increase
  1281.   throughput dramatically, assuming the files aren't already
  1282.   compressed with Stuffit, Compact Pro, etc.
  1283.   
  1284.   The reason you should ignore the percent efficiency is that ZTerm
  1285.   normally calculates percent transfer efficiency by dividing the
  1286.   actual throughput by the DTE speed (what ZTerm calls the data
  1287.   rate).  Assuming your modem is transferring data at exactly 14400,
  1288.   ZTerm will report the efficiency to be 14400/19200 = 75% at 19200,
  1289.   14400/38400 = 38% at 38400, and 14400/57600 = 25% at 57600.  Yet in
  1290.   each case the actual transfer efficiency is the same.
  1291.   
  1292.   Having said all of that, you can use the percent effiency figure if
  1293.   your modem supports the ATW2 command.  When the modem is set to W2,
  1294.   ZTerm reports the connect speed as the DCE speed rather than the
  1295.   DTE speed, and calculates percent efficiency based on the DCE
  1296.   speed.  So if your modem is transferring data at exactly 14400,
  1297.   ZTerm will report the efficiency to be 14400/14400 = 100%.
  1298.   
  1299.   
  1300.   [8]    Sound, ANSI Graphics, and Color
  1301.   
  1302.   [8.1]  Why oh why won't the ZTerm sounds play?
  1303.   
  1304.   The sounds must be stored in the System file (AKA System suitcase).
  1305.    See 8.2.
  1306.   
  1307.   [8.2]  Can I use sounds other than the ones that come with ZTerm?
  1308.   
  1309.   Absolutely.  You can rename any system-compatible sound to
  1310.   "Connect", "Filedone" or "Termbell" and install the sound in the
  1311.   System file.  Under System 7, quit all applications and desk
  1312.   accessories and drag the sounds to the icon of the closed System
  1313.   Folder.  When asked if you want the sounds installed in the system
  1314.   file, click OK.
  1315.   
  1316.   System 6 users can install sounds into the System file using the
  1317.   shareware SoundMover (shareware by Riccardo Etore) or Apple's
  1318.   ResEdit.  You can also use a resource manager, such as Fifth
  1319.   Generation System's SuitCase or Alsoft's MasterJuggler, to open the
  1320.   sounds with ZTerm.
  1321.   
  1322.   [8.3]  Is there any limit on the length of the sounds?
  1323.   
  1324.   ZTerm doesn't limit the length of the sounds, but ZTerm can't send
  1325.   or receive data while the sounds are playing.  Therefore, a long
  1326.   connect sound may cause connection problems.
  1327.   
  1328.   [8.4]  How do I turn my modem speaker down or off?
  1329.   
  1330.   This one is near and dear to my heart, as I used to have the 2400
  1331.   bps Modem for the Deaf(TM).  ZTerm offers three ways to turn the
  1332.   modem speaker off (AT M0), or to turn the speaker down (AT L0) if
  1333.   it's on.  (All 0's are zeroes, as they always are in the Hayes
  1334.   language.  The only exception is The ATOn command, which is used to
  1335.   return the modem to online mode.  In that case, "O" is an "oh". The
  1336.   n is a placeholder for an integer number.)  M1 turns the speaker
  1337.   back on.  L1 turns the volume back up.
  1338.   
  1339.   1. You can manually do the deed by typing AT M0 or AT L0 before you
  1340.   make a connection.  This method is best if you only want to silence
  1341.   the modem for some sessions.
  1342.   
  1343.   2. To automatically change the volume when dialing a particualr
  1344.   service, enter AT M0 or AT L0 in the "Pre-dial init" field in that
  1345.   service's Connection dialog.  This method is best if you want the
  1346.   speaker on for some services and off for others.
  1347.   
  1348.   3. To automatically control the volume for all services, select
  1349.   Modem Preferences.  Click in the "Initialize" field and use the
  1350.   cursor keys to move to the far right.  Move the cursor just to the
  1351.   left of ^M  and type M0 or L0.  This method is best if you want the
  1352.   speaker off for every service, every time.
  1353.   
  1354.   These three techniques work for any initialization string,
  1355.   incidentally.
  1356.   
  1357.   [8.5]  Why can't women see what a great guy I am?
  1358.   
  1359.   Man!  I've been trying to figure out the same thing for years. You
  1360.   tell me.
  1361.   
  1362.   [8.6]  How do I get ANSI graphics when connecting to a PC BBS?
  1363.   
  1364.   1. Select Terminal Settings for that service and choose the PC ANSI
  1365.   BBS radio button.
  1366.   
  1367.   2. Also in the Terminal Settings dialog, uncheck the "No Extended
  1368.   Characters (Strip hi bit)" box if it's checked.
  1369.   
  1370.   3. In the Color Preferences dialog, check the Use Color box.
  1371.   
  1372.   4. In the Terminal Preferences dialog, set the font size to 9 or 12
  1373.   point.  Other sizes will not work with ANSI graphics.  See 10.2.
  1374.   
  1375.   5. In the Monitors control panel, set the monitor depth to 256
  1376.   colors or higher.  16 colors will do in a pinch.  If your Mac is
  1377.   limited to 16 colors, I recommend using Jon Snell's ZTerm High
  1378.   Speed Patch, which installs a 16 color palette into ZTerm.
  1379.   
  1380.   [8.7]  I did all of that and the ANSI graphics still look a
  1381.          little funny.  What gives?
  1382.   
  1383.   ZTerm 0.9 uses 8 colors for ANSI emulation, while some ANSI
  1384.   graphics use 16 colors.  The next version will support 16 color
  1385.   ANSI emulation.
  1386.   
  1387.   [8.8]  How can I add excitement to my dull and monotonous life?
  1388.   
  1389.   Select Color Preferences and choose colored text on a darker
  1390.   background.  I use yellow text on a black background.  Use whatever
  1391.   colors you want.  It's your life.
  1392.   
  1393.   
  1394.   [9]    VT100 Emulation
  1395.   
  1396.   [9.1]  I'm wiggin' out, Leslie.  Why don't the home, end, page
  1397.          up, and page down keys on my extended keyboard work?
  1398.   
  1399.   During VT100 emulation, those keys are assigned to VT100
  1400.   operations.  To make them work like normal Macintosh application
  1401.   keys, hold down the shift key and then press them.
  1402.   
  1403.   [9.2]  Why don't the f1-f4 editing keys on my extended keyboard
  1404.          work?
  1405.   
  1406.   During VT100 emulation, all of the function keys are assigned to
  1407.   VT100 operations.  Use the command key shortcuts or the edit menu.
  1408.   
  1409.   [9.3]  How can I emulate a control key on a Mac Plus?
  1410.   
  1411.   If you are using System 7 on a U.S. system, install the ZTerm
  1412.   Keyboard layout.  To do this, drag the keyboard layout to the icon
  1413.   of the closed system folder.  When asked if you want to install the
  1414.   keyboard layout, click OK.  The option key will now emulate the
  1415.   control key.
  1416.   
  1417.   If you are using a non-U.S. system, or a system earlier than 7.0,
  1418.   select Terminal Settings from the Settings menu.  Assign the
  1419.   control key function to the command key.
  1420.   
  1421.   [9.4]  How can I emulate an escape key on a Mac Plus?
  1422.   
  1423.   When Option for Control is checked in Terminal Preferences, the
  1424.   accent/grave key in the upper left hand corner of the keyboard
  1425.   emulates the escape key.
  1426.   
  1427.   [9.5]  How can I emulate a VT100 numeric keypad on a PowerBook?
  1428.   
  1429.   Use NumericKeypad (AKA U.S. Keypad), a ResEdit resource and keypad
  1430.   written by Mel Park, of the University of Tennessee, Memphis. 
  1431.   NumericKeypad maps the numeric keypad to the regular keyboard when
  1432.   the caps lock key is engaged.
  1433.   
  1434.   [9.6]  Undocumented tip: positioning the cursor with the mouse.
  1435.   
  1436.   Not only can you use the mouse to select text, you can also use it
  1437.   to position the cursor when in editing mode.  Hold down the option
  1438.   key.  The pointer will become diamond shaped and will move the
  1439.   cursor, somewhat slowly, to wherever you click.
  1440.   
  1441.   
  1442.   [10]   Text and Text Files
  1443.   
  1444.   [10.1] Can I make the terminal font bigger?
  1445.   
  1446.   Yes.  Select Terminal Preferences from the Settings menu and enter
  1447.   a larger size.
  1448.   
  1449.   [10.2] Why does onscreen text look so crummy in anything but 9 or
  1450.          12 point?
  1451.   
  1452.   ZTerm uses its own terminal font for 9 and 12 point, but uses
  1453.   Monaco for other sizes.  If you want to see ANSI graphics, it is
  1454.   essential that you select 9 or 12 point.  Monaco doesn't contain
  1455.   the special characters needed for ANSI emulation.
  1456.   
  1457.   A font-morphing wiz could help Dave Alverson and ZTerm users by
  1458.   creating, say, 10 and 11 point sizes of the ZTerm font.  Contact
  1459.   Dave Alverson if you're interested.
  1460.   
  1461.   [10.3] Will ZTerm save text files in something other than
  1462.          TeachText?
  1463.   
  1464.   Yes.  To change the application ZTerm saves text files in, choose
  1465.   General Preferences from the Settings menu and choose a new file
  1466.   creator.  TeachText can't open files larger than 32K, so this
  1467.   feature is especially useful if you save large text files.
  1468.   
  1469.   [10.4] How can I increase the size of the scroll buffer?
  1470.   
  1471.   ZTerm stores the contents of the scroll buffer in memory.  To
  1472.   increase the memory partition, increase the current size in ZTerm's
  1473.   Get Info window.  One user has reported that setting the memory
  1474.   size above 1000K disables scrolling, but I was unable to duplicate
  1475.   that problem.  If you experience trouble with large memory
  1476.   settings, reduce the setting below 1000K.
  1477.   
  1478.   [10.5] Why do some characters get corrupted when I copy text from
  1479.          my word processor and paste it into ZTerm?
  1480.   
  1481.   The characters you've pasted are illegal on the system you're
  1482.   logged in to.  A lengthy explanation follows.
  1483.   
  1484.   On the Macintosh, all eight bits of a byte are used for 
  1485.   characters, producing 256 possible characters (two to the eighth
  1486.   power is 256), though some of these are dead keys, command keys,
  1487.   etc.  Mainframes use only seven bits for text, producing only 128
  1488.   possible characters (two to the seventh power is 128).  This seven
  1489.   bit text is the ASCII standard (American Standard for Information
  1490.   Interchange, pronounced "asskey").  If you use any characters which
  1491.   use the eighth bit, the mainframe ignores the last bit and uses the
  1492.   first seven bits to determine which character to display.
  1493.   
  1494.   To avoid illegal characters when composing text for a mainframe,
  1495.   never use any characters which require pressing the option key.
  1496.   Also, in your word processor, turn off smart (curly) quotes , which
  1497.   use the eighth bit.  When smart quotes are turned on, the word
  1498.   "don't" usually becomes "donUt" when pasted to a mainframe.  And
  1499.   I'll bet dollars to donUts you donUt want that to happen.
  1500.   
  1501.   If you need to upload or paste text files containing illegal eighth
  1502.   bit characters, process the file with the Zap Gremlins command in
  1503.   BBEdit Lite 2.3 (freeware by Richard Siegel).
  1504.   
  1505.   [10.6] Undocumented tip: changing the terminal font with ResEdit.
  1506.   
  1507.   Shigeru Yamamoto asked Dave how to use ZTerm with a Japanese font. 
  1508.   Dave's instructions follow: 
  1509.   
  1510.   "If you want to try a Japanese font, here's what to do: open the
  1511.   ZPhoneList file with ResEdit and open the zSet resource.  (Leave
  1512.   the one in the program file alone, it's only used as defaults when
  1513.   the ZPhoneList is created.)  At offset 80 hex in this resource is
  1514.   the font name used when emulation is set to VT100.  At 90 hex is
  1515.   the font for PC-ANSI.  They are pascal strings, so the first byte
  1516.   is the number of characters in the name.  They are fixed fields of
  1517.   16 bytes, so the longest name that will work is 15 bytes.  Make
  1518.   sure you don't change the size of the field, because everything
  1519.   after it is position dependent."
  1520.   
  1521.   
  1522.   [11]   Macros and Scripting
  1523.   
  1524.   See also 4.5 for an explanation of a scripting bug and an easy fix.
  1525.   
  1526.   [11.1] How do I know the script is running?
  1527.   
  1528.   You will see a letter or two in the lower right hand corner of the
  1529.   terminal window.  These letters are abbreviations for the command
  1530.   the script is preparing to execute.  By noting which commands have
  1531.   executed, you can debug scripts more easily.
  1532.   
  1533.   These are the abbreviations and their meanings, as provided by Dave
  1534.   Alverson:
  1535.   
  1536.   b : beep
  1537.   s : send
  1538.   w : wait
  1539.   wp: wait prompt
  1540.   wq: wait for quiet
  1541.   
  1542.   [11.2] How do I cancel a script?
  1543.   
  1544.   Hold down the command key and type a period.  Command-period, AKA
  1545.   the Universal Mac Distress Code, also cancels printing and pastes,
  1546.   in ZTerm or most other applications, and is the keyboard shortcut
  1547.   for the cancel button in most dialog boxes.
  1548.   
  1549.   [11.3] How do I send an escape/linefeed/etc. in a script?
  1550.   
  1551.   To send an escape, use the line:
  1552.   
  1553.     send "^["
  1554.   
  1555.   where "[" is the lowercase left hand bracket, and "^" is the
  1556.   shift-6 control character.  Substitute "^j" for linefeeds. 
  1557.   Basically, you can send any ASCII character using a script.  All
  1558.   you need is a table of ASCII characters and their meaning.
  1559.   
  1560.   [11.4] Do I have to use the Wait for "da da da" prompt syntax?
  1561.   
  1562.   No.
  1563.   
  1564.     Wait prompt "da da da"
  1565.   
  1566.   works just fine.
  1567.   
  1568.   [11.5] Why is ZTerm sending only part of a line?
  1569.   
  1570.   When a line begins with the "send" command, ZTerm sends everything
  1571.   between the first set of quotes and the second set of quotes.  If
  1572.   the string looks like this:
  1573.   
  1574.     send " "It is not I who am crazy ... It is I who am MAD!!!" ^M"
  1575.   
  1576.   ZTerm will send a space, since that's what is between the first and
  1577.   second set of quotes.
  1578.   
  1579.   [11.6] How can I send quotation marks within a send statement?
  1580.   
  1581.   I used to say it couldn't be done, but I found a way.
  1582.   
  1583.   ZTerm recognizes four varieties of quotation marks: single quote,
  1584.   double quote, smart single quote, and smart double quote.  If you
  1585.   begin a send statement with one type, ZTerm won't stop sending
  1586.   until it reaches another quote of the same type.  (It doesn't,
  1587.   however, care which way the smart quotes face.)  For instance, if
  1588.   the send line looks like this:
  1589.   
  1590.     send ' "It is not I who am crazy ... It is I who am MAD!!!" ^M'
  1591.   
  1592.   ZTerm will send everything within the single quote marks
  1593.   (apostrophes).
  1594.   
  1595.   If your send string contains double and single quotes, enclose the
  1596.   string within smart quotes.  KeyCaps DA will show you the correct
  1597.   keys for producing smart quotes in your word processor or text
  1598.   editor.  As a rule of thumb, don't enclose smart quotes within the
  1599.   send string.  See 10.5.
  1600.   
  1601.   [11.7] What does error -49 mean?
  1602.   
  1603.   It means that the script ZTerm tried to use is open in another
  1604.   application, such as your word processor.  Close the file and try
  1605.   again.
  1606.   
  1607.   [11.8] I'm goin' nuts! Why won't my login script run?
  1608.   
  1609.   There could be a number of reasons.
  1610.   
  1611.   1. The file may not be in the right place.  Login scripts must be
  1612.   stored in the root level of the ZTerm folder.  That is, you should
  1613.   be able to see the ZTerm application and the script in the same
  1614.   Finder window using an icon view.
  1615.   
  1616.   2. The file may not have the correct name.  Login scripts should
  1617.   have the same name as the service, with the ".zts" extension on the
  1618.   end.  If the service is called " MacClique" (note the space), the
  1619.   script should be called " MacClique.zts", with a space.
  1620.   
  1621.   3. The script may not be in text only format.  ZTerm can only read
  1622.   text only files (files of type code text), such as TeachText files.
  1623.   If you write the script with your word processor, be sure to use
  1624.   the Save As command and select a text only format.  If TeachText
  1625.   can't open the file, it is not in text only format.  One exception:
  1626.   TeachText can't open any file larger than 32K.  Or had I mentioned
  1627.   that already?  If you have a working, useful script larger than
  1628.   32K, I'd like to shake your hand.
  1629.   
  1630.   4. The script may be an alias.  ZTerm doesn't recognize aliased
  1631.   scripts.
  1632.   
  1633.   5. There may be something wrong with your login script.  To test
  1634.   your script, connect to the service, select the Run Script command,
  1635.   and tell ZTerm to use the login script.  If the script doesn't work
  1636.   when run manually, the script is faulty.  Check spelling and
  1637.   syntax.  
  1638.   
  1639.   [11.9]Login script example
  1640.   
  1641.   The login script for my university's timesharing network follows:
  1642.   
  1643.   wait prompt "ENTER HOST NAME OR HELP >"
  1644.   send "vax^M"
  1645.   wait prompt "Username:"
  1646.   send $account "^M"
  1647.   wait prompt "Password:"
  1648.   send $password "^M"
  1649.   
  1650.   Note that $account and $password are NOT inside quotation marks. 
  1651.   For this script to work, the values for $account and $password must
  1652.   be entered into the Connection dialog.
  1653.   
  1654.   [11.10]Undocumented tip: sending a sig with a script and macro.
  1655.   
  1656.   UNIX users often include a signature at the end of their messages. 
  1657.   The signature, or sig, often includes the person's name, email
  1658.   address, affiliation, etc.  Sigs are automated in UNIX.  ZTerm
  1659.   users can easily include a sig with their email by creating a sig
  1660.   script.
  1661.   
  1662.   Launch your favorite text editor or word processor, set the font to
  1663.   Monaco, and write the sig as you want it to appear.  Then enclose
  1664.   each line of text in quotation marks, type "send" without the
  1665.   quotes in front of each line, and include a ^M before the second
  1666.   set of quotation marks.  To send a blank line, send a ^M by itself.
  1667.   Save the script in the ZTerm folder and name it sig.  If you use a
  1668.   word processor, be sure to use Save As and save in a text only
  1669.   format.
  1670.   
  1671.   Example:
  1672.   
  1673.   send
  1674.   "************************************************************^M"
  1675.   send "Leslie Jones       ljones@utkvx.utk.edu      AOL:
  1676.   LeslieJonz^M"
  1677.   send "^M"
  1678.   send "Made from only the freshest electrons and 100% pure ASCII
  1679.   to^M"
  1680.   send "  insure that you have the best possible email experience.^M"
  1681.   send
  1682.   "************************************************************^M"
  1683.   
  1684.   Now launch ZTerm and choose Edit Macros from the Macro menu.  Name
  1685.   the new macro sig, and type "(option-r)sig" in the Macro String
  1686.   field.  Now your sig is only a macro away.  You could also use the
  1687.   Run Script command under the Macro menu, but it wouldn't be as
  1688.   convenient.  Enjoy!
  1689.   
  1690.   [11.11]Other uses of scripts and macros
  1691.   
  1692.   Scripts and macros can eliminate a lot of needless typing.  The
  1693.   following is a script I concocted to speed up Kermit transfers on
  1694.   the VAX.  (I'm really looking forward to Kermit support in the next
  1695.   version of ZTerm!)
  1696.   
  1697.   Example:
  1698.   
  1699.   wait "kermit>" prompt
  1700.   send  "SET BLOCK_CHECK_TYPE THREE_CHARACTER_CRC_CCITT^M"
  1701.   wait "kermit>" prompt
  1702.   send "SET SEND PACKET_LENGTH 1000^M"
  1703.   wait "kermit>" prompt
  1704.   send "SET RECEIVE PACKET_LENGTH 1000^M"
  1705.   
  1706.   I use the following script to log on to the sumex-aim FTP site.
  1707.   
  1708.   send "FTP sumex-aim.stanford.edu^M"
  1709.   wait prompt "Username:"
  1710.   send "anonymous^M"
  1711.   wait prompt "Password:"
  1712.   send "ljones@utkvx.utk.edu^M"
  1713.   wait prompt "FTP>"
  1714.   send "cd info-mac^M"
  1715.   
  1716.   As in the example in 11.10, I could trigger these scripts with a
  1717.   macro or with the "run script" command.
  1718.   
  1719.   
  1720.   And finally, an Easter Egg.  Open a copy of ZTerm in ResEdit.
  1721.   Doubleclick on the STR resource, then doubleclick on the ID=0
  1722.   resource.  Inside you'll see a line from Monty Python.  Enjoy!
  1723.   
  1724.   
  1725.   Send in those corrections and tips!  And send Dave your shareware
  1726.   fee!
  1727.   
  1728.